home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / inet / internet-drafts / draft-ietf-bgp-mibv4-02.txt < prev    next >
Text File  |  1993-07-27  |  35KB  |  1,017 lines
  1.  
  2.  
  3. Network Working Group                                        S. Willis
  4. INTERNET DRAFT                                              J. Burruss
  5.                                          Wellfleet Communications Inc.
  6.                                                                 J. Chu
  7.                                                               IBM Corp
  8.                                                          July 27, 1993
  9.  
  10.  
  11.                      Definitions of Managed Objects
  12.               for the Border Gateway Protocol (Version 4)
  13.  
  14.  
  15. Status of this Memo
  16.  
  17.    This document is an Internet Draft.  Internet Drafts are working
  18.    documents of the Internet Engineering Task Force (IETF), its Areas,
  19.    and its Working Groups. Note that other groups may also distribute
  20.    working documents as Internet Drafts.
  21.  
  22.    Internet Drafts are draft documents valid for a maximum of six
  23.    months. Internet Drafts may be updated, replaced, or obsoleted by
  24.    other documents at any time.  It is not appropriate to use Internet
  25.    Drafts as reference material or to cite them other than as a "working
  26.    draft" or "work in progress."
  27.  
  28.    Please check the I-D abstract listing contained in each Internet
  29.    Draft directory to learn the current status of this or any other
  30.    Internet Draft.
  31.  
  32.    This memo is an extension to the SNMP MIB.  It specifies an IAB
  33.    standards track protocol for the Internet community, and requests
  34.    discussion and suggestions for improvements.  The origin of this memo
  35.    is from RFC 1269 "Definitions of Managed Objects for the Board
  36.    Gateway Protocol (Version 3)" written by the first two authors of
  37.    this memo.
  38.  
  39.    Distribution of this memo is unlimited. Please forward comments to
  40.    bgp@ans.net.
  41.  
  42.  
  43. 1.  Abstract
  44.  
  45.    This memo defines a portion of the Management Information Base (MIB)
  46.    for use with network management protocols in TCP/IP-based internets.
  47.    In particular, it defines objects for managing the Border Gateway
  48.    Protocol [11,12].
  49.  
  50.  
  51.  
  52.  
  53.  
  54. Expiration Date February 1994                           [Page 1]
  55.  
  56.  
  57.  
  58.  
  59.  
  60. INTERNET DRAFT                 BGP-4 MIB                   July 27, 1993
  61.  
  62.  
  63. 2.  The Network Management Framework
  64.  
  65.    The Internet-standard Network Management Framework consists of three
  66.    components.  They are:
  67.  
  68.       RFC 1155 which defines the SMI, the mechanisms used for describing
  69.       and naming objects for the purpose of management.  RFC 1212
  70.       defines a more concise description mechanism, which is wholly
  71.       consistent with the SMI.
  72.  
  73.       RFC 1156 which defines MIB-I, the core set of managed objects for
  74.       the Internet suite of protocols.  RFC 1213, defines MIB-II, an
  75.       evolution of MIB-I based on implementation experience and new
  76.       operational requirements.
  77.  
  78.       RFC 1157 which defines the SNMP, the protocol used for network
  79.       access to managed objects.
  80.  
  81.    The Framework permits new objects to be defined for the purpose of
  82.    experimentation and evaluation.
  83.  
  84.  
  85. 3.  Objects
  86.  
  87.    Managed objects are accessed via a virtual information store, termed
  88.    the Management Information Base or MIB.  Objects in the MIB are
  89.    defined using the subset of Abstract Syntax Notation One (ASN.1) [7]
  90.    defined in the SMI.  In particular, each object has a name, a syntax,
  91.    and an encoding.  The name is an object identifier, an
  92.    administratively assigned name, which specifies an object type.  The
  93.    object type together with an object instance serves to uniquely
  94.    identify a specific instantiation of the object.  For human
  95.    convenience, we often use a textual string, termed the OBJECT
  96.    DESCRIPTOR, to also refer to the object type.
  97.  
  98.    The syntax of an object type defines the abstract data structure
  99.    corresponding to that object type.  The ASN.1 language is used for
  100.    this purpose.  However, the SMI [3] purposely restricts the ASN.1
  101.    constructs which may be used.  These restrictions are explicitly made
  102.    for simplicity.
  103.  
  104.    The encoding of an object type is simply how that object type is
  105.    represented using the object type's syntax.  Implicitly tied to the
  106.    notion of an object type's syntax and encoding is how the object type
  107.    is represented when being transmitted on the network.
  108.  
  109.    The SMI specifies the use of the basic encoding rules of ASN.1 [8],
  110.    subject to the additional requirements imposed by the SNMP.
  111.  
  112.  
  113.  
  114. Expiration Date February 1994                           [Page 2]
  115.  
  116.  
  117.  
  118.  
  119.  
  120. INTERNET DRAFT                 BGP-4 MIB                   July 27, 1993
  121.  
  122.  
  123. 3.1.  Format of Definitions
  124.  
  125.    Section 5 contains contains the specification of all object types
  126.    contained in this MIB module.  The object types are defined using the
  127.    conventions defined in the SMI, as amended by the extensions
  128.    specified in [9,10].
  129.  
  130.  
  131. 4.  Overview
  132.  
  133.    These objects are used to control and manage a BGP [11,12]
  134.    implementation.
  135.  
  136.    The Border Gateway Protocol (BGP) is an inter-Autonomous System
  137.    routing protocol.  The primary function of a BGP speaking system is
  138.    to exchange network reachability information with other BGP systems.
  139.    This network reachability information includes information on the
  140.    full path of Autonomous Systems that traffic must transit to reach
  141.    these networks.
  142.  
  143.    BGP runs over a reliable transport protocol.  This eliminates the
  144.    need to implement explicit update fragmentation, retransmission,
  145.    acknowledgement, and sequencing.  Any authentication scheme used by
  146.    the transport protocol may be used in addition to BGP's own
  147.    authentication mechanisms.
  148.  
  149.    The planned use of BGP in the Internet environment, including such
  150.    issues as topology, the interaction between BGP and IGPs, and the
  151.    enforcement of routing policy rules is presented in a companion
  152.    document [12].
  153.  
  154.    Apart from a few system variables, this MIB is broken into two
  155.    tables: the BGP Peer Table and the BGP Received Path Attribute Table.
  156.    The Peer Table reflects information about BGP peer connections, such
  157.    as their state and current activity.  The Received Path Attribute
  158.    Table contains all attributes received from all peers before local
  159.    routing policy has been applied.  The actual attributes used in
  160.    determining a route are a subset of the received attribute table.
  161.  
  162.  
  163. 5.  Definitions
  164.  
  165.                RFCxxxx-MIB DEFINITIONS ::= BEGIN
  166.  
  167.                IMPORTS
  168.                     NetworkAddress, IpAddress, Counter
  169.                          FROM RFC1155-SMI
  170.                     mib-2
  171.  
  172.  
  173.  
  174. Expiration Date February 1994                           [Page 3]
  175.  
  176.  
  177.  
  178.  
  179.  
  180. INTERNET DRAFT                 BGP-4 MIB                   July 27, 1993
  181.  
  182.  
  183.                          FROM RFC1213-MIB
  184.                   OBJECT-TYPE
  185.                          FROM RFC-1212
  186.                     TRAP-TYPE
  187.                          FROM RFC-1215;
  188.  
  189.                -- This MIB module uses the extended OBJECT-TYPE macro as
  190.                -- defined in [9], and the TRAP-TYPE macro as defined
  191.                -- in [10].
  192.  
  193.                bgp     OBJECT IDENTIFIER ::= { mib-2 15 }
  194.  
  195.  
  196.                bgpVersion OBJECT-TYPE
  197.                     SYNTAX OCTET STRING
  198.                     ACCESS read-only
  199.                     STATUS mandatory
  200.                     DESCRIPTION
  201.                          "Vector of supported BGP protocol version
  202.                          numbers. Each peer negotiates the version from
  203.                          this vector.  Versions are identified via the
  204.                          string of bits contained within this object.
  205.                          The first octet contains bits 0 to 7, the
  206.                          second octet contains bits 8 to 15, and so on,
  207.                          with the most significant bit referring to the
  208.                          lowest bit number in the octet (e.g., the MSB
  209.                          of the first octet refers to bit 0).  If a bit,
  210.                          i, is present and set, then the version (i+1)
  211.                          of the BGP is supported."
  212.                     ::= { bgp 1 }
  213.  
  214.                bgpLocalAs OBJECT-TYPE
  215.                     SYNTAX INTEGER (0..65535)
  216.                     ACCESS read-only
  217.                     STATUS mandatory
  218.                     DESCRIPTION
  219.                          "The local autonomous system number."
  220.                     ::= { bgp 2 }
  221.  
  222.                bgpPeerTable OBJECT-TYPE
  223.                     SYNTAX SEQUENCE OF BgpPeerEntry
  224.                     ACCESS not-accessible
  225.                     STATUS mandatory
  226.                     DESCRIPTION
  227.                          "The bgp peer table."
  228.                     ::= { bgp 3 }
  229.  
  230.                bgpIdentifier OBJECT-TYPE
  231.  
  232.  
  233.  
  234. Expiration Date February 1994                           [Page 4]
  235.  
  236.  
  237.  
  238.  
  239.  
  240. INTERNET DRAFT                 BGP-4 MIB                   July 27, 1993
  241.  
  242.  
  243.                     SYNTAX IpAddress
  244.                     ACCESS read-only
  245.                     STATUS mandatory
  246.                     DESCRIPTION
  247.                          "The BGP Identifier of local system."
  248.                     ::= { bgp 4 }
  249.  
  250.                bgpPeerEntry OBJECT-TYPE
  251.                     SYNTAX BgpPeerEntry
  252.                     ACCESS not-accessible
  253.                     STATUS mandatory
  254.                     DESCRIPTION
  255.                          "Information about a BGP peer connection."
  256.                     INDEX
  257.                          { bgpPeerRemoteAddr }
  258.                         ::= { bgpPeerTable 1 }
  259.  
  260.                BgpPeerEntry ::= SEQUENCE {
  261.                     bgpPeerIdentifier
  262.                          IpAddress,
  263.                     bgpPeerState
  264.                          INTEGER,
  265.                     bgpPeerAdminStatus
  266.                          INTEGER,
  267.                     bgpPeerNegotiatedVersion
  268.                          INTEGER,
  269.                     bgpPeerLocalAddr
  270.                          IpAddress,
  271.                     bgpPeerLocalPort
  272.                          INTEGER,
  273.                     bgpPeerRemoteAddr
  274.                          IpAddress,
  275.                     bgpPeerRemotePort
  276.                          INTEGER,
  277.                     bgpPeerRemoteAs
  278.                          INTEGER,
  279.                     bgpPeerInUpdates
  280.                          Counter,
  281.                     bgpPeerOutUpdates
  282.                          Counter,
  283.                     bgpPeerInTotalMessages
  284.                          Counter,
  285.                     bgpPeerOutTotalMessages
  286.                          Counter,
  287.                     bgpPeerLastError
  288.                          OCTET STRING,
  289.                     bgpPeerFsmEstablishedTransitions
  290.                          Counter
  291.  
  292.  
  293.  
  294. Expiration Date February 1994                           [Page 5]
  295.  
  296.  
  297.  
  298.  
  299.  
  300. INTERNET DRAFT                 BGP-4 MIB                   July 27, 1993
  301.  
  302.  
  303.                     }
  304.  
  305.                bgpPeerIdentifier OBJECT-TYPE
  306.                     SYNTAX IpAddress
  307.                     ACCESS read-only
  308.                     STATUS mandatory
  309.                     DESCRIPTION
  310.                          "The BGP Identifier of this entry's BGP peer."
  311.                     ::= { bgpPeerEntry 1 }
  312.  
  313.                bgpPeerState OBJECT-TYPE
  314.                     SYNTAX INTEGER {
  315.                          idle(1),
  316.                          connect(2),
  317.                          active(3),
  318.                          opensent(4),
  319.                          openconfirm(5),
  320.                          established(6)
  321.                     }
  322.                     ACCESS read-only
  323.                     STATUS mandatory
  324.                     DESCRIPTION
  325.                          "The bgp peer connection state. "
  326.                     ::= { bgpPeerEntry 2 }
  327.  
  328.                bgpPeerAdminStatus OBJECT-TYPE
  329.                     SYNTAX INTEGER {
  330.                          stop(1),
  331.                          start(2)
  332.                     }
  333.                     ACCESS read-write
  334.                     STATUS mandatory
  335.                     DESCRIPTION
  336.                          "The desired state of the BGP connection. A
  337.                          transition from 'stop' to 'start' will cause
  338.                          the BGP Start Event to be generated. A
  339.                          transition from 'start' to 'stop' will cause
  340.                          the BGP Stop Event to be generated. This
  341.                          parameter can be used to restart BGP peer
  342.                          connections.  Care should be used in providing
  343.                          write access to this object without adequate
  344.                          authentication."
  345.                     ::= { bgpPeerEntry 3 }
  346.  
  347.                bgpPeerNegotiatedVersion OBJECT-TYPE
  348.                     SYNTAX INTEGER
  349.                     ACCESS read-only
  350.                     STATUS mandatory
  351.  
  352.  
  353.  
  354. Expiration Date February 1994                           [Page 6]
  355.  
  356.  
  357.  
  358.  
  359.  
  360. INTERNET DRAFT                 BGP-4 MIB                   July 27, 1993
  361.  
  362.  
  363.                     DESCRIPTION
  364.                          "The negotiated version of BGP running between
  365.                          the two peers. "
  366.                     ::= { bgpPeerEntry 4 }
  367.  
  368.                bgpPeerLocalAddr OBJECT-TYPE
  369.                     SYNTAX IpAddress
  370.                     ACCESS read-only
  371.                     STATUS mandatory
  372.                     DESCRIPTION
  373.                          "The local IP address of this entry's BGP
  374.                          connection."
  375.                     ::= { bgpPeerEntry 5 }
  376.  
  377.                bgpPeerLocalPort OBJECT-TYPE
  378.                     SYNTAX INTEGER (0..65535)
  379.                     ACCESS read-only
  380.                     STATUS mandatory
  381.                     DESCRIPTION
  382.                          "The local port for the TCP connection between
  383.                          the BGP peers."
  384.                     ::= { bgpPeerEntry 6 }
  385.  
  386.                bgpPeerRemoteAddr OBJECT-TYPE
  387.                     SYNTAX IpAddress
  388.                     ACCESS read-only
  389.                     STATUS mandatory
  390.                     DESCRIPTION
  391.                          "The remote IP address of this entry's BGP
  392.                          peer."
  393.                     ::= { bgpPeerEntry 7 }
  394.  
  395.                bgpPeerRemotePort OBJECT-TYPE
  396.                     SYNTAX INTEGER (0..65535)
  397.                     ACCESS read-only
  398.                     STATUS mandatory
  399.                     DESCRIPTION
  400.                          "The remote port for the TCP connection between
  401.                          the BGP peers.  Note that the objects
  402.                          bgpLocalAddr, bgpLocalPort, bgpRemoteAddr and
  403.                          bgpRemotePort provide the appropriate reference
  404.                          to the standard MIB TCP connection table."
  405.                     ::= { bgpPeerEntry 8 }
  406.  
  407.                bgpPeerRemoteAs OBJECT-TYPE
  408.                     SYNTAX INTEGER (0..65535)
  409.                     ACCESS read-only
  410.                     STATUS mandatory
  411.  
  412.  
  413.  
  414. Expiration Date February 1994                           [Page 7]
  415.  
  416.  
  417.  
  418.  
  419.  
  420. INTERNET DRAFT                 BGP-4 MIB                   July 27, 1993
  421.  
  422.  
  423.                     DESCRIPTION
  424.                          "The remote autonomous system number."
  425.                     ::= { bgpPeerEntry 9 }
  426.  
  427.                bgpPeerInUpdates OBJECT-TYPE
  428.                     SYNTAX Counter
  429.                     ACCESS read-only
  430.                     STATUS mandatory
  431.                     DESCRIPTION
  432.                          "The number of BGP UPDATE messages received on
  433.                          this connection. This object should be
  434.                          initialized to zero when the connection is
  435.                          established."
  436.                     ::= { bgpPeerEntry 10 }
  437.  
  438.                bgpPeerOutUpdates OBJECT-TYPE
  439.                     SYNTAX Counter
  440.                     ACCESS read-only
  441.                     STATUS mandatory
  442.                     DESCRIPTION
  443.                          "The number of BGP UPDATE messages received on
  444.                          this connection. This object should be
  445.                          initialized to zero when the connection is
  446.                          established."
  447.                     ::= { bgpPeerEntry 11}
  448.  
  449.                bgpPeerInTotalMessages OBJECT-TYPE
  450.                     SYNTAX Counter
  451.                     ACCESS read-only
  452.                     STATUS mandatory
  453.                     DESCRIPTION
  454.                          "The total number of messages received from the
  455.                          remote peer on this connection. This object
  456.                          should be initialized to zero when the
  457.                          connection is established."
  458.                     ::= { bgpPeerEntry 12 }
  459.  
  460.                bgpPeerOutTotalMessages OBJECT-TYPE
  461.                     SYNTAX Counter
  462.                     ACCESS read-only
  463.                     STATUS mandatory
  464.                     DESCRIPTION
  465.                          "The total number of messages transmitted to
  466.                          the remote peer on this connection. This object
  467.                          should be initialized to zero when the
  468.                          connection is established."
  469.                     ::= { bgpPeerEntry 13 }
  470.  
  471.  
  472.  
  473.  
  474. Expiration Date February 1994                           [Page 8]
  475.  
  476.  
  477.  
  478.  
  479.  
  480. INTERNET DRAFT                 BGP-4 MIB                   July 27, 1993
  481.  
  482.  
  483.                bgpPeerLastError OBJECT-TYPE
  484.                     SYNTAX OCTET STRING (SIZE (2))
  485.                     ACCESS read-only
  486.                     STATUS mandatory
  487.                     DESCRIPTION
  488.                          "The last error code and subcode seen by this
  489.                          peer on this connection. If no error has
  490.                          occurred, this field is zero. Otherwise, the
  491.                          first byte of this two byte OCTET STRING
  492.                          contains the error code; the second contains
  493.                          the subcode."
  494.                     ::= { bgpPeerEntry 14 }
  495.  
  496.                bgpPeerFsmEstablishedTransitions OBJECT-TYPE
  497.                     SYNTAX Counter
  498.                     ACCESS read-only
  499.                     STATUS mandatory
  500.                     DESCRIPTION
  501.                          "The total number of times the BGP FSM
  502.                           transitioned into the established state."
  503.                     ::= { bgpPeerEntry 15 }
  504.  
  505.  
  506.  
  507.                bgpRcvdPathAttrTable OBJECT-TYPE
  508.                     SYNTAX SEQUENCE OF BgpPathAttrEntry
  509.                     ACCESS not-accessible
  510.                     STATUS mandatory
  511.                     DESCRIPTION
  512.                          "The BGP Received Path Attribute Table contains
  513.                          information about paths to destination networks
  514.                          received by all peers running BGP version 3 or
  515.                          less."
  516.                     ::= { bgp 5 }
  517.  
  518.                bgpPathAttrEntry OBJECT-TYPE
  519.                     SYNTAX BgpPathAttrEntry
  520.                     ACCESS not-accessible
  521.                     STATUS mandatory
  522.                     DESCRIPTION
  523.                          "Information about a path to a network."
  524.                     INDEX
  525.                          { bgpPathAttrDestNetwork,
  526.                            bgpPathAttrPeer        }
  527.                     ::= { bgpRcvdPathAttrTable 1 }
  528.  
  529.                BgpPathAttrEntry ::= SEQUENCE {
  530.                     bgpPathAttrPeer
  531.  
  532.  
  533.  
  534. Expiration Date February 1994                           [Page 9]
  535.  
  536.  
  537.  
  538.  
  539.  
  540. INTERNET DRAFT                 BGP-4 MIB                   July 27, 1993
  541.  
  542.  
  543.                          IpAddress,
  544.                     bgpPathAttrDestNetwork
  545.                          IpAddress,
  546.                     bgpPathAttrOrigin
  547.                          INTEGER,
  548.                     bgpPathAttrASPath
  549.                          OCTET STRING,
  550.                     bgpPathAttrNextHop
  551.                          IpAddress,
  552.                     bgpPathAttrInterASMetric
  553.                          INTEGER
  554.                     }
  555.  
  556.                bgpPathAttrPeer OBJECT-TYPE
  557.                     SYNTAX IpAddress
  558.                     ACCESS read-only
  559.                     STATUS mandatory
  560.                     DESCRIPTION
  561.                          "The IP address of the peer where the path
  562.                          information
  563.                           was learned."
  564.                     ::= { bgpPathAttrEntry 1 }
  565.  
  566.                bgpPathAttrDestNetwork OBJECT-TYPE
  567.                     SYNTAX IpAddress
  568.                     ACCESS read-only
  569.                     STATUS mandatory
  570.                     DESCRIPTION
  571.                          "The address of the destination network."
  572.                     ::= { bgpPathAttrEntry 2 }
  573.  
  574.                bgpPathAttrOrigin OBJECT-TYPE
  575.                     SYNTAX INTEGER {
  576.                          igp(1),-- networks are interior
  577.                          egp(2),-- networks learned via EGP
  578.                          incomplete(3) -- undetermined
  579.                     }
  580.                     ACCESS read-only
  581.                     STATUS mandatory
  582.                     DESCRIPTION
  583.                          "The ultimate origin of the path information."
  584.                     ::= { bgpPathAttrEntry 3 }
  585.  
  586.                bgpPathAttrASPath OBJECT-TYPE
  587.                     SYNTAX OCTET STRING
  588.                     ACCESS read-only
  589.                     STATUS mandatory
  590.                     DESCRIPTION
  591.  
  592.  
  593.  
  594. Expiration Date February 1994                          [Page 10]
  595.  
  596.  
  597.  
  598.  
  599.  
  600. INTERNET DRAFT                 BGP-4 MIB                   July 27, 1993
  601.  
  602.  
  603.                          "The set of ASs that must be traversed to reach
  604.                          the network. ( This object is probably best
  605.                          represented as SEQUENCE OF INTEGER. For SMI
  606.                          compatibility, though, it is represented as
  607.                          OCTET STRING. Each AS is represented as a pair
  608.                          of octets according to the following algorithm:
  609.  
  610.                               first-byte-of-pair = ASNumber / 256;
  611.                               second-byte-of-pair = ASNumber & 255;"
  612.                     ::= { bgpPathAttrEntry 4 }
  613.  
  614.                bgpPathAttrNextHop OBJECT-TYPE
  615.                     SYNTAX IpAddress
  616.                     ACCESS read-only
  617.                     STATUS mandatory
  618.                     DESCRIPTION
  619.                          "The address of the border router that should
  620.                          be used for the destination network."
  621.                     ::= { bgpPathAttrEntry 5 }
  622.  
  623.                bgpPathAttrInterASMetric OBJECT-TYPE
  624. |                   SYNTAX INTEGER
  625.                     ACCESS read-only
  626.                     STATUS mandatory
  627.                     DESCRIPTION
  628.                          "The optional inter-AS metric. If this
  629.                          attribute has not been provided for this route,
  630.                          the value for this object is 0."
  631.                     ::= { bgpPathAttrEntry 6 }
  632.  
  633.  
  634.  
  635.                bgp4RcvdPathAttrTable OBJECT-TYPE
  636.                     SYNTAX SEQUENCE OF Bgp4PathAttrEntry
  637.                     ACCESS not-accessible
  638.                     STATUS mandatory
  639.                     DESCRIPTION
  640.                          "The BGP-4 Received Path Attribute Table contains
  641.                          information about paths to destination networks
  642.                          received by all BGP4 peers."
  643.                     ::= { bgp 6 }
  644.  
  645.                bgp4PathAttrEntry OBJECT-TYPE
  646.                     SYNTAX Bgp4PathAttrEntry
  647.                     ACCESS not-accessible
  648.                     STATUS mandatory
  649.                     DESCRIPTION
  650.                          "Information about a path to a network."
  651.  
  652.  
  653.  
  654. Expiration Date February 1994                          [Page 11]
  655.  
  656.  
  657.  
  658.  
  659.  
  660. INTERNET DRAFT                 BGP-4 MIB                   July 27, 1993
  661.  
  662.  
  663.                     INDEX
  664.                          { bgp4PathAttrPeer,
  665.                            bgp4PathAttrIpAddrPrefixLen,
  666.                            bgp4PathAttrIpAddrPrefix    }
  667.                     ::= { bgp4RcvdPathAttrTable 1 }
  668.  
  669.                Bgp4PathAttrEntry ::= SEQUENCE {
  670.                     bgp4PathAttrPeer
  671.                          IpAddress,
  672.                     bgp4PathAttrIpAddrPrefixLen
  673.                          INTEGER,
  674.                     bgp4PathAttrIpAddrPrefix
  675.                          OCTET STRING,
  676.                     bgp4PathAttrOrigin
  677.                          INTEGER,
  678.                     bgp4PathAttrASPathSegment
  679.                          OCTET STRING,
  680.                     bgp4PathAttrNextHop
  681.                          IpAddress,
  682.                     bgp4PathAttrMultiExitDisc
  683.                          INTEGER,
  684.                     bgp4PathAttrLocalPref
  685.                          INTEGER,
  686.                     bgp4PathAttrAtomicAggregate
  687.                          INTEGER,
  688.                     bgp4PathAttrAggregator
  689.                          INTEGER
  690.                     }
  691.  
  692.                bgp4PathAttrPeer OBJECT-TYPE
  693.                     SYNTAX IpAddress
  694.                     ACCESS read-only
  695.                     STATUS mandatory
  696.                     DESCRIPTION
  697.                          "The IP address of the peer where the path
  698.                          information was learned."
  699.                     ::= { bgp4PathAttrEntry 1 }
  700.  
  701.                bgp4PathAttrIpAddrPrefixLen OBJECT-TYPE
  702.                     SYNTAX INTEGER (0..255)
  703.                     ACCESS read-only
  704.                     STATUS mandatory
  705.                     DESCRIPTION
  706.                          "Length in bits of the IP address prefix in the
  707.                           Network Layer Reachability Information field."
  708.                     ::= { bgp4PathAttrEntry 2 }
  709.  
  710.                bgp4PathAttrIpAddrPrefix OBJECT-TYPE
  711.  
  712.  
  713.  
  714. Expiration Date February 1994                          [Page 12]
  715.  
  716.  
  717.  
  718.  
  719.  
  720. INTERNET DRAFT                 BGP-4 MIB                   July 27, 1993
  721.  
  722.  
  723.                     SYNTAX OCTET STRING
  724.                     ACCESS read-only
  725.                     STATUS mandatory
  726.                     DESCRIPTION
  727.                          "An IP address prefix in the Network Layer
  728.                           Reachability Information field.  This string
  729.                           contains as many octets as necessary to hold
  730.                           a prefix of the length specified by
  731.                           bgp4PathAttrIpAddrPrefixLen.  Any bits
  732.                           beyond the length specified by
  733.                           bgp4PathAttrIpAddrPrefixLen are zeroed."
  734.                     ::= { bgp4PathAttrEntry 3 }
  735.  
  736.                bgp4PathAttrOrigin OBJECT-TYPE
  737.                     SYNTAX INTEGER {
  738.                          igp(1),-- networks are interior
  739.                          egp(2),-- networks learned via EGP
  740.                          incomplete(3) -- undetermined
  741.                     }
  742.                     ACCESS read-only
  743.                     STATUS mandatory
  744.                     DESCRIPTION
  745.                          "The ultimate origin of the path
  746.                           information."
  747.                     ::= { bgp4PathAttrEntry 4 }
  748.  
  749.                bgp4PathAttrASPathSegment OBJECT-TYPE
  750.                     SYNTAX OCTET STRING
  751.                     ACCESS read-only
  752.                     STATUS mandatory
  753.                     DESCRIPTION
  754.                          "The sequence of AS path segments. Each AS
  755.                           path segment is represented by a triple
  756.                          <type, length, value>.
  757.  
  758.                          The type is a 1-octet field which has two
  759.                          possible values:
  760.                               1      AS_SET: unordered set of ASs a
  761.                                           route in the UPDATE message
  762.                                           has traversed
  763.                               2      AS_SEQUENCE: ordered set of ASs
  764.                                           a route in the UPDATE message
  765.                                           has traversed.
  766.  
  767.                           The length is a 1-octet field containing the
  768.                           number of ASs in the value field.
  769.  
  770.                           The value field contains one or more AS
  771.  
  772.  
  773.  
  774. Expiration Date February 1994                          [Page 13]
  775.  
  776.  
  777.  
  778.  
  779.  
  780. INTERNET DRAFT                 BGP-4 MIB                   July 27, 1993
  781.  
  782.  
  783.                           numbers, each AS is represented in the octet
  784.                           string as a pair of octets according to the
  785.                           following algorithm:
  786.  
  787.                                first-byte-of-pair = ASNumber / 256;
  788.                                second-byte-of-pair = ASNumber & 255;"
  789.                     ::= { bgp4PathAttrEntry 5 }
  790.  
  791.                bgp4PathAttrNextHop OBJECT-TYPE
  792.                     SYNTAX IpAddress
  793.                     ACCESS read-only
  794.                     STATUS mandatory
  795.                     DESCRIPTION
  796.                          "The address of the border router that should
  797.                          be used for the destination network."
  798.                     ::= { bgp4PathAttrEntry 6 }
  799.  
  800.                 bgp4PathAttrMultiExitDisc OBJECT-TYPE
  801.                     SYNTAX INTEGER (0..255)
  802.                     ACCESS read-only
  803.                     STATUS mandatory
  804.                     DESCRIPTION
  805.                          "This metric is used to discriminate between
  806.                           multiple exit points to an adjacent autonomous
  807.                           system."
  808.                     ::= { bgp4PathAttrEntry 7 }
  809.  
  810.                bgp4PathAttrLocalPref OBJECT-TYPE
  811.                     SYNTAX INTEGER (0..255)
  812.                     ACCESS read-only
  813.                     STATUS mandatory
  814.                     DESCRIPTION
  815.                          "The originating BGP4 speaker's degree of
  816.                           preference for an advertised route."
  817.                     ::= { bgp4PathAttrEntry 8 }
  818.  
  819.                bgp4PathAttrAtomicAggregate OBJECT-TYPE
  820.                     SYNTAX INTEGER {
  821.                          less-specific-route-not-selected(1),
  822.                          less-specific-route-selected(2)
  823.                     }
  824.                     ACCESS read-only
  825.                     STATUS mandatory
  826.                     DESCRIPTION
  827.                          "Whether or not the local system has selected
  828.                           a less specific route without selecting a
  829.                           more specific route."
  830.                     ::= { bgp4PathAttrEntry 9 }
  831.  
  832.  
  833.  
  834. Expiration Date February 1994                          [Page 14]
  835.  
  836.  
  837.  
  838.  
  839.  
  840. INTERNET DRAFT                 BGP-4 MIB                   July 27, 1993
  841.  
  842.  
  843.                bgp4PathAttrAggregator OBJECT-TYPE
  844.                     SYNTAX INTEGER (0..65535)
  845.                     ACCESS read-only
  846.                     STATUS mandatory
  847.                     DESCRIPTION
  848.                         "The AS number of the last BGP4 speaker that
  849.                          performed route aggregation. "
  850.                     ::= { bgp4PathAttrEntry 10 }
  851.  
  852.  
  853.  
  854.                bgpEstablished TRAP-TYPE
  855.                     ENTERPRISE { bgp }
  856.                     VARIABLES  { bgpPeerRemoteAddr,
  857.                                  bgpPeerLastError,
  858.                                  bgpPeerState      }
  859.                     DESCRIPTION
  860.                          "The BGP Established event is generated when
  861.                          the BGP FSM enters the ESTABLISHED state. "
  862.                     ::= 1
  863.  
  864.                bgpBackwardTransition TRAP-TYPE
  865.                     ENTERPRISE { bgp }
  866.                     VARIABLES  { bgpPeerRemoteAddr,
  867.                                  bgpPeerLastError,
  868.                                  bgpPeerState      }
  869.                     DESCRIPTION
  870.                          "The BGPBackwardTransition Event is generated
  871.                          when the BGP FSM moves from a higher numbered
  872.                          state to a lower numbered state."
  873.                     ::= 2
  874.                END
  875.  
  876.  
  877. 6.  Acknowledgements
  878.  
  879.    We would like to acknowledge the assistance of all the members of the
  880.    Interconnectivity Working Group, and particularly the following
  881.    individuals:
  882.  
  883.                 Yakov Rekhter, IBM
  884.                 Rob Coltun, University of Maryland
  885.                 Guy Almes, ANS
  886.                 Jeff Honig, Cornell Theory Center
  887.                 Marshall T. Rose, PSI, Inc.
  888.                 Dennis Ferguson, ANS
  889.                 Mike Mathis, PSC
  890.                 John Krawczyk, Wellfleet Communications Inc.
  891.  
  892.  
  893.  
  894. Expiration Date February 1994                          [Page 15]
  895.  
  896.  
  897.  
  898.  
  899.  
  900. INTERNET DRAFT                 BGP-4 MIB                   July 27, 1993
  901.  
  902.  
  903.                 Curtis Villamizar, ANS
  904.                 Dave LeRoy, Pencom Systems
  905.  
  906.  
  907.  
  908. 7.  References
  909.  
  910.  
  911.    [1] Cerf, V., "IAB Recommendations for the Development of Internet
  912.        Network Management Standards", RFC 1052, NRI, April 1988.
  913.  
  914.    [2] Cerf, V., "Report of the Second Ad Hoc Network Management Review
  915.        Group", RFC 1109, NRI, August 1989.
  916.  
  917.    [3] Rose M., and K. McCloghrie, "Structure and Identification of
  918.        Management Information for TCP/IP-based internets", RFC 1155,
  919.        Performance Systems International, Hughes LAN Systems, May 1990.
  920.  
  921.    [4] McCloghrie K., and M. Rose, "Management Information Base for
  922.        Network Management of TCP/IP-based internets", RFC 1156, Hughes
  923.        LAN Systems, Performance Systems International, May 1990.
  924.  
  925.    [5] Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple
  926.        Network Management Protocol", RFC 1157, SNMP Research,
  927.        Performance Systems International, Performance Systems
  928.        International, MIT Laboratory for Computer Science, May 1990.
  929.  
  930.    [6] McCloghrie K., and M. Rose, Editors, "Management Information Base
  931.        for Network Management of TCP/IP-based internets", RFC 1213,
  932.        Performance Systems International, March 1991.
  933.  
  934.    [7] Information processing systems - Open Systems Interconnection -
  935.        Specification of Abstract Syntax Notation One (ASN.1),
  936.        International Organization for Standardization, International
  937.        Standard 8824, December 1987.
  938.  
  939.    [8] Information processing systems - Open Systems Interconnection -
  940.        Specification of Basic Encoding Rules for Abstract Notation One
  941.        (ASN.1), International Organization for Standardization,
  942.        International Standard 8825, December 1987.
  943.  
  944.    [9] Rose, M., and K. McCloghrie, Editors, "Concise MIB Definitions",
  945.        RFC 1212, Performance Systems International, Hughes LAN Systems,
  946.        March 1991.
  947.  
  948.    [10] Rose, M., Editor, "A Convention for Defining Traps for use with
  949.         the SNMP", RFC 1215, Performance Systems International, March
  950.         1991.
  951.  
  952.  
  953.  
  954. Expiration Date February 1994                          [Page 16]
  955.  
  956.  
  957.  
  958.  
  959.  
  960. INTERNET DRAFT                 BGP-4 MIB                   July 27, 1993
  961.  
  962.  
  963.    [11] Rekhter, Y., and Li, T., "A Border Gateway Protocol 4 (BGP-4)",
  964.         Internet Draft, T.J. Watson Research Center, IBM Corp.,
  965.         cisco Systems, June 1992.
  966.  
  967.    [12] Rekhter, Y., and P. Gross, Editors, "Application of the Border
  968.         Gateway Protocol in the Internet", RFC 1268, T.J. Watson
  969.         Research Center, IBM Corp., ANS, October 1991.
  970.  
  971.  
  972. 8.  Security Considerations
  973.  
  974.    Security issues are not discussed in this memo.
  975.  
  976.  
  977.  
  978. Authors' Addresses
  979.  
  980.    Steven Willis
  981.    Wellfleet Communications Inc.
  982.    15 Crosby Drive
  983.    Bedford, MA 01730
  984.  
  985.    Phone: (617) 275-2400
  986.    Email: swillis@wellfleet.com
  987.  
  988.  
  989.    John Burruss
  990.    Wellfleet Communications Inc.
  991.    15 Crosby Drive
  992.    Bedford, MA 01730
  993.  
  994.    Phone: (617) 275-2400
  995.    Email: jburruss@wellfleet.com
  996.  
  997.  
  998.    John Chu
  999.    IBM Corp.
  1000.    P.O.Box 218
  1001.    Yorktown Heights, NY 10598
  1002.  
  1003.    Phone: (914) 945-3156
  1004.    Email: jychu@watson.ibm.com
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014. Expiration Date February 1994                          [Page 17]
  1015.  
  1016.  
  1017.